home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_plotutils.idb / usr / freeware / share / libplot / README.z / README
Encoding:
Text File  |  1998-10-28  |  3.6 KB  |  78 lines
  1. This directory contains supplementary documentation on GNU libplot, the
  2. drawing library on which the plotting utilities graph, plot, and tek2plot
  3. are based.
  4.  
  5.     ./colors.txt: A listing of the color names recognized by libplot,
  6.             and hence by each of the three plotting utilities.  
  7.             A 24-bit RGB representation for each color is given.
  8.  
  9.             For example, you may use the command
  10.  
  11.             graph --frame-color chocolate
  12.  
  13.           because "chocolate" is one of the listed color names.
  14.           In the 24-bit RGB scheme, "chocolate" means (210,105,30).
  15.           The strength of each of R (red), G (green), and B (blue)
  16.           is represented as an 8-bit quantity, i.e., an integer
  17.           in the range 0..255.
  18.  
  19. The following files are relevant to the 21 Hershey fonts built into GNU
  20. libplot, and accessible to the plotting utilities.
  21.  
  22.     ./demo-page: A sample page, in portable GNU metafile format, 
  23.          illustrating many of the Hershey fonts.  The page is 
  24.          taken from  Allen Hershey's 1972 article in 
  25.          Computer Graphics and Image Processing 
  26.          (vol. 1, no. 4, pp. 373-385). You would use the `plot' 
  27.          utility to display the page.
  28.          For example, do `plot -T X demo-page' to display the
  29.          page on an X Window System display,
  30.          `plot -T ps demo-page > demo-page.ps' to prepare a
  31.          Postscript version of the page, 
  32.          `plot -T fig demo-page > demo-page.fig' to prepare a
  33.          version of the page that can be edited with the `xfig'
  34.          drawing editor, etc.
  35.     
  36.     ./h-demo.c:  The program that was used to generate `./demo-page'.
  37.          You may compile this program and link it with GNU libplot 
  38.          (the instructions are at the head of the file).  It will
  39.          send the sample page to standard output, in portable 
  40.          GNU metafile format.  This program illustrates how to 
  41.          write a C program that invokes GNU libplot functions.
  42.  
  43.     ./h-fonts: Excerpts from Allen Hershey's `Calligraphy for Computers',
  44.     explaining the origin of the Hershey fonts.
  45.  
  46. When specifying to the plotting utilities that a Hershey font should be
  47. used, you would usually specify it by name, e.g., `graph --font-name
  48. HersheyGothicEnglish'.  However, the Hershey fonts are assembled from a
  49. large collection of glyphs (`Hershey glyphs'), including many
  50. symbols in addition to occidental and Japanese characters.  If the current
  51. font is a Hershey font, you may access any glyph by its number, even if it
  52. is not a character in the font. For example, the command
  53.  
  54.     graph --font-name HersheyGothic-English -L '\#H0745\#H0745'
  55.  
  56. would label the graph being drawn with a title line consisting of
  57. two fleurs-de-lys.  That is because the fleur-de-lys is Hershey glyph #745.
  58.  
  59.     ./h-glyphs: A breakdown of the `occidental' Hershey glyphs,
  60.         by number.  Includes an extensive comparison with earlier
  61.     (pre-GNU) distributions of the Hershey glyphs, and an explanation
  62.     of how the glyph array was assembled.
  63.     
  64.     ./hershey.bib: A bibliography, in BibTeX format, of publications
  65.         dealing with the Hershey glyphs and with Allen Hershey's system for
  66.         scientific typography, which was designed to use them.  Most cited
  67.         items are technical reports that are available from the
  68.         U.S. National Technical Information Service (+1 703 487 4650).
  69.         Stock numbers are given.
  70.     
  71.     ./kana.doc: The encodings used for the Hershey Hiragana and Katakana
  72.         (syllabic Japanese characters).  These are part of the HersheyEUC
  73.     font, but may also be accessed by number.
  74.     
  75.     ./kanji.doc: The encoding of the 603 available Japanese Kanji
  76.         (ideographic characters), and their meaning.  These are part of the
  77.     HersheyEUC font, but may also be accessed by number.
  78.